Keithley Instruments 2700-852B01 Release Notes for Version B01 IVI Instrument Driver for the Model 2700, 2701, and 2750 7/17/2002 This document provides additional information for the installation and use of the 2700-852B01 2700/2750/2701 driver for both LabView and LabWindows CVI. ------------------------------------------------- Contents: 1. Introduction 1.1 Included in this release 1.1.1 KE2700 IVI Driver for the 2700, 2701, and 2750 1.1.2 Keithley Configuration Panel and Wizard 1.2 New Features in this Release 1.2.1 New Features in KE2700 IVI Driver 1.3 Additional available software 2. System Requirements 3. Installation 3.1 GPIB Controller Installation 3.1.1 Keithley and INES PCMCIA Controller Installation 3.2 Connecting your Computer to your Instrument 3.3 Upgrading from a previous version of the 2700 IVI Instrument Driver 3.4 Software Installation 3.4.1 Installing the driver from CD 3.4.2 Installing the driver from the Web 3.4.3 Installing Only the Keithley I/O Layer 4. Using the 2700 IVI Instrument Driver 4.1 VISA resources 4.1.1 GPIB 4.1.2 RS232 4.1.3 Ethernet (Socket connection) 4.1.4 Example of using VISA resources 4.2 Predefined Resource Aliases 4.3 Create your own Resource Aliases 4.4 Driver speed up solutions 4.4.1 QueryInstrStatus 4.4.2 RangeCheck 4.4.3 Caching 5. Known problems and issues 5.1 Use data type STRING in VB instead of ViString 5.2 Timeout issues 5.3 Two functions that do the same thing ------------------------------------------------- 1. Introduction 1.1 Included in this release The components described below are provided as part of the 2700 Series IVI Instrument Driver. Some shortcuts for them are added to the Keithley Instruments folder on your Start Menu. 1.1.1 KE2700 Series IVI Driver for the 2700, 2701, and 2750 The 2700 Series IVI Instrument driver conforms to the IVI DMM Class specification. The driver uses the Keithley I/O layer (VISA) to communicate with your instrument. IVI (Interchangeable Virtual Instruments) and VISA (Virtual Instrument Software Architecture) provide a common foundation for application development across multiple communication buses and multiple instrument vendors. This software driver supports many Application Development Environments under Windows, such as Visual Basic, C/C++, LabView, LabWindows/CVI, and TestPoint. Numerous examples and an on-line help utility are provided to help programmers build their custom applications. 1.1.2 Keithley Configuration Panel and Wizard The Keithley Configuration Panel is provided to allow you to setup or modify the communications between the driver and your instrument. For an IVI driver to be truly interchangeable you need to create an alias which points to the VISA resource to use, the name of the DLL to use and the prefix for the function calls in the DLL. The Configuration Panel and Wizard allow you to do this. The installation pre-configures instruments for Serial ports COM1 and COM2, and for a GPIB instrument at GPIB address 16. If you are using one of these, you may skip the configuration panel. Otherwise, you must create a new instrument configuration using the Keithley Configuration Panel and Wizard. See instructions below. The Configuration Panel also allows you to control which NI VISA Passport drivers get loaded. Passport drivers are "shims" between the VISA DLL and the actual specific hardware drivers. They allow any vendor who creates a Passport to integrate their I/O hardware into NI VISA. 1.2 New Features in this Release 1.2.2 New Feature in KE2700 Series IVI Instrument Driver The following new features have been added to the KE2700 Series IVI Instrument Driver: Includes full support for Model 2701 Ethernet Based DMM. KE2700 now supports 7700, 7701, 7702, 7703, 7705, 7706, 7707, 7708, 7709, 7710, 7711, and 7712 Switch Cards. Includes new I/O Configuration Wizard to simplify configuration of instrument communications. Supports 1 and 10 ohm ranges (2750 only). Supports Windows XP Pro. Supports LabView 6.1. Includes VISA 2.6. 1.3 Additional available software ExceLINX-1A is a Microsoft Excel add-in for the 2700, 2701, and 2750 systems. Within minutes of installing ExceLINX-1A on a PC, users can acquire data dynamically within Excel, and then employ the familiar Excel graphics, charting, and analysis capabilities. No Programming is required to use ExceLINX - a few mouse clicks are all it takes to configure channels, set parameters, triggers, scan lists, etc. ExceLINX is sold separately. Check Keithley.com or call 1-888-KEITHLEY (534-8453) for more information. TestPoint Professional Development System is a complete package for creating test & measurement applications, including support for GPIB and serial instruments, control, math, graphing, A/D and many more features. ------------------------------------------------- 2. System Requirements Pentium-class PC running either: Windows 98 or later NT 4.0(sp6) or later The instrument needs the following firmware versions: 2700 firmware release B03 or later 2701 firmware release A01 or later 2750 firmware release A02 or later. Supported GPIB controller (see section 3.1), Ethernet controller (2701 only), or RS-232 Serial port for communications with the instrument. ------------------------------------------------- 3. Installation 3.1 GPIB Controller Installation If you will be using GPIB to communicate with your instrument, you must have a compatible GPIB controller card and associated software driver installed in your computer before installing the 2700 Series IVI Instrument Driver. The driver is compatible with the following GPIB controller cards: Keithley Instruments GPIB cards (ISA, PCI, PCMCIA) CEC GPIB cards (ISA, PCI) National Instruments GPIB cards (ISA, PCI, PCMCIA) INES GPIB cards (PCMCIA) When using Keithley Instruments or CEC ISA or PCI GPIB cards, you must have driver software version 5.14 or later. The latest driver for these cards is available from the CEC WEB site: www.cec488.com. Follow the manufacturer's instructions for installing the controller card and software, and for verifying correct operation of the card and software driver. (PR15839) 3.1.1 Keithley and INES PCMCIA Controller Installation When installing the INES driver software, do NOT install the HP I/O libraries or select HP SICL emulation. When installing the INES driver software, DO select NI compatibility mode. When installing the INES driver software, if the hardware test fails, change the Interrupt selection to none. 3.2 Connecting your Computer to your Instrument Connect your Keithley 2700 or 2750 to your computer using a standard GPIB interface cable or a "straight through" (not null-modem) serial RS-232 cable. For 2701 Ethernet Connections, refer to the quick start guide that is provided with the instrument. 3.3 Upgrading from a previous version of the 2700 Series IVI Instrument Driver If you have an earlier version of the driver software installed on your computer, uninstall it by following the steps below before installing this version. Using the Add/Remove Programs Wizard in Control Panel, uninstall the following components: Keithley 2700 IVI Driver. Keithley I/O Layer. NI-VISA Runtime (If present). Reboot your computer. 3.4 2700 Series IVI Instrument Driver Installation 3.4.1 Installing the driver from CD The 2700 Series IVI Instrument Driver is included on the Testpoint Runtime CD. If you have a previous version of the 2700 IVI Instrument Driver installed on your computer, uninstall it as described above before installing the new version. Before installing from the CD, it is recommended you visit www.keithley.com to see if a newer version of the driver is available. Insert the TestPoint Runtime CD in your computer. The installation utility should start automatically. If it does not start automatically, run the install.exe file in the root directory of the CD. Follow the instructions on the screen to install the software. If you don't want the Testpoint Runtime Application installed then navigate on the CD to the 2700 driver folder and run the setup.exe from there. When the installation is complete, reboot your computer. 3.4.2 Installing the driver from the Web If you have a previous version of the 2700 IVI Instrument Driver installed on your computer, uninstall it as described above before installing the new version. Download the driver software from the Keithley Web site, www.keithley.com. The software is a single compressed file, approximately 10 MB in size, and should be download to a temporary directory. Run the downloaded file from the temporary directory. Follow the instructions on the screen to install the software. When the installation is complete, reboot your computer. 3.4.3 Installing only the Keithley I/O Layer Installing the 2700 Series IVI Instrument Driver automatically installs the Keithley I/O Layer and NI-VISA runtime. If you wish to install only the I/O Layer and not the instrument driver, run the setup.exe file in the KeithleyIOLayer subdirectory of the CD. ------------------------------------------------- 4. Using the 2700 IVI Instrument Driver To connect to the instrument via the driver you need to first call KE2700_init or KE2700_InitWithOptions. The first parameter for either function is a VISA resource string, which indicates to the I/O layer, which communication device you want to use to connect to the instrument and in most cases the address of the instrument. 4.1 VISA resources 4.1.1 GPIB For GPIB instruments you would use a resource string of the following format: "GPIBx::yy::INSTR". x is the GPIB card number. yy is the GPIB address of the instrument to connect to 4.1.2 RS232 For RS232 instruments the VISA resource string has the following format, "ASRLx::INSTR" where x is the COM Port number. 4.1.3 Ethernet (Socket connection) For Ethernet instruments, such as the 2701, use the following VISA resource string format, "TCPIPx::IP::Port::SOCKET". x is the Ethernet card number. IP is the IP address of the instrument. Port is the port number of the instrument (2701 is 1394). 4.1.4 Example of using VISA resources KE2700_init("TCPIP0::10.12.90.115::1394::SOCKET", VI_TRUE, VI_TRUE, handle) would connect to a 2701 on IP address "10.12.90.115". 4.2 Resource Aliases The Keithley I/O Layer installer creates several aliases that you can use to automatically connect to an instrument. If you are using a National Instruments GPIB card, select KE2700_GPIB16 as your device. If you are using a Keithley Instruments or CEC ISA or PCI GPIB card, select KE2700_GPIB1_16 as your device. If you are using a Keithley Instrument or INES PCMCIA GPIB card, select KE2700_GPIB2_16 as your device. If you are using COM Port 1, select KE2700_COM1 as your device. If you are using COM Port 2, select KE2700_COM2 as your device. An example of using a VISA resource alias to connect to an instrument connected to COM Port 1 is: KE2700_init("KE2700_COM1", VI_TRUE, VI_TRUE, handle) 4.3 Create your own Resource Aliases If you want to create your own resource aliases then use the Configuration Panel or Wizard. Open the Configuration Panel by selecting Start>Programs>Keithley Instruments>Keithley Configuration Panel, and wait for the Wizard to start. Follow the Wizard instructions to create a new configuration or modify an existing one. 4.4 Driver Speed up solutions Using the KE2700_InitWithOptions function there is a parameter, called OptionString, where you can enable/disable certain features of an IVI driver. 4.4.1 QueryInstrStatus If this feature is enabled the driver will query the instrument after every function call to see if there where any errors. This is useful while you are writing your application but once it is finalized then you can disable this feature to gain extra performance. 4.4.2 RangeCheck If enabled the IVI engine will check to see if the parameters you are passing in are within range. Disabling this feature in the final application will also gain some performance increase. 4.4.3 Caching The driver has the option of caching all the settings it sends to the instrument so that it doesn't send a setting to the instrument a second time if it hasn't changed. By default this is enabled. ------------------------------------------------- 5. Known problems and issues 5.1 PR19585: Where ever you see the following data types in the Visual BASIC help file: ViChar, ViChar[], ViString or ViConstString use the VB data type STRING. If you use one of these data types your VB program will run but when the code executes it will generate an error, "Invalid data type for automation". All the VB examples use the correct data type. 5.2 PR19573: Fetch Buffer Data.vi & example Read_Buffer.vi - Max time exceeded before operation completed. If using large buffers then increase the timeout value. 5.3 PR18886: KE2700_ConfigureFixedRefJunction and KE2700_ConfigureSimRefJunction are duplicate functions. Use KE2700_ConfigureFixedRefJuntion. ------------------------------------------------- Notice: The VISA software supplied with the 2700 Series IVI Instrument Driver is Copyright (c) 2001 National Instruments Corporation. All Rights Reserved. The KE2700 Series instrument driver is Copyright (c) 2001, 2002 Keithley Instruments. All Rights Reserved. ------------------------------------------------- End of Release notes.